Launching SDK / Library / Source Code Marketplace soon.. Stay Tuned. Email - Support@allthingsdev.co for more information.
Logo
Login / Signup

Sorry

To continue you need to log in

project-logo

Geocoding API

Verified
Free API
| updated a year ago |

location

Rating

-

Popularity

-

Latency

363 ms

Followers

0

Votes

0

Rating: 0.0


Geocoding API Documentation

Preview and API URL

Name Latitude Longitude Elevation Population Admin1 Admin2 Admin3 Admin4 Feature code
Berlin 52.52437 13.41053 74 3426354 Land Berlin Berlin, Stadt Berlin PPLC
Berlin 44.46867 -71.18508 311 9367 New Hampshire Coos City of Berlin PPL
Berlin 39.79123 -74.92905 50 7590 New Jersey Camden Borough of Berlin PPL
Berlin 43.96804 -89.93445 246 5420 Wisconsin Green Lake City of Berlin PPL
Berlin 38.32262 -75.21769 11 4529 Maryland Worcester PPL
Berlin 42.3812 -71.63701 100 2422 Massachusetts Worcester Town of Berlin PPL
Berlin 39.92064 -78.9578 710 2019 Pennsylvania Somerset Borough of Berlin PPL
East Berlin 39.9376 -76.97859 131 1534 Pennsylvania Adams Borough of East Berlin PPL
Berlin 40.56117 -81.79431 391 898 Ohio Holmes Berlin Township PPL
Berlin 54.00603 61.19308 228 613 Chelyabinsk Troitskiy Rayon PPL

API URL: Open in new tab
You can copy this API URL into your application

API Documentation

The API endpoint https://geocoding-api.open-meteo.com/v1/search accepts a search term and returns a list of matching locations. URL parameters are listed below:

Parameter Format Required Default Description
name String Yes String to search for. An empty string or only 1 character will return an empty result. 2 characters will only match exact matching locations. 3 and more characters will perform fuzzy matching. The search string can be a location name or a postal code.
count Integer No 10 The number of search results to return. Up to 100 results can be retrieved.
format String No json By default, results are returned as JSON. Alternatively, protobuf is supported for more efficient encoding and transfer. The .proto file to decode the protobuf message is available in the geocoding GitHub repository.
language String No en Return translated results, if available, otherwise return English or the native location name. Lower-cased.
apikey String No Only required for commercial use to access reserved API resources for customers. The server URL requires the prefix customer-. See pricing for more information.

Additional optional URL parameters will be added in the future. For API stability, no required parameters will be added in the future!

JSON Return Object

On success a JSON object will be returned. Empty fields are not returned. E.g. admin4 will be missing if no fourth administrative level is available.

"results": [
{
"id": 2950159,
"name": "Berlin",
"latitude": 52.52437,
"longitude": 13.41053,
"elevation": 74.0,
"feature_code": "PPLC",
"country_code": "DE",
"admin1_id": 2950157,
"admin2_id": 0,
"admin3_id": 6547383,
"admin4_id": 6547539,
"timezone": "Europe/Berlin",
"population": 3426354,
"postcodes": [
"10967",
"13347"
],
"country_id": 2921044,
"country": "Deutschland",
"admin1": "Berlin",
"admin2": "",
"admin3": "Berlin, Stadt",
"admin4": "Berlin"
},
{
...
}]

*Note: All IDs can be can be resolved via the API endpoint https://geocoding-api.open-meteo.com/v1/get?id=2950159

Errors

In case an error occurs, for example a URL parameter is not correctly specified, a JSON error object is returned with a HTTP 400 status code.

"error": true,
"reason": "Parameter count must be between 1 and 100."

Attribution

Location data based on GeoNames
Country flags from HatScripts/circle-flags

Sorry

To continue you need to log in